Programming with QuickTime VR

Hot Spot Information Atom Structure

A hot spot information atom contains general information about a hot spot. The structure of a hot spot information atom is defined by the VRHotSpotInfoAtom data type:



 
typedef struct VRHotSpotInfoAtom {

    UInt16                              majorVersion;

    UInt16                              minorVersion;

    OSType                              hotSpotType;

    QTAtomID                            nameAtomID;

    QTAtomID                            commentAtomID;

    SInt32                              cursorID[3];

    Float32                             bestPan;

    Float32                             bestTilt;

    Float32                             bestFOV;

    FloatPoint                          bestViewCenter;

    Rect                                hotSpotRect;

    UInt32                              flags;

    UInt32                              reserved1;

    UInt32                              reserved2;

} VRHotSpotInfoAtom, *VRHotSpotInfoAtomPtr;

majorVersion: The major version number of the file format.
minorVersion: The minor version number of the file format.
hotSpotType: The hot spot type. See handlink "QuickTime VR Manager/Hot Spot Types" for a description of the predefined hot spot types.
nameAtomID: The ID of the string atom that contains the name of the hot spot. This atom should be a sibling of the hot spot atom. The value of this field is 0 if no name atom exists.
commentAtomID: The ID of the string atom that contains a comment for the hot spot. This atom should be a sibling of the hot spot atom. The value of this field is 0 if no comment atom exists.
cursorID: An array of three IDs for custom hot spot cursors (that is, cursors that override the default hot spot cursors provided by QuickTime VR). The first ID (cursorID[0] ) specifies the cursor that is displayed when it is in the hot spot. The second ID (cursorID[1] ) specifies the cursor that is displayed when it is in the hot spot and the mouse button is down. The third ID (cursorID[2] ) specifies the cursor that is displayed when it is in the hot spot and the mouse button is released. To retain the default cursor for any of these operations, set the corresponding cursor ID to 0.
bestPan: The best pan angle for viewing this hot spot.
bestTilt: The best tilt angle for viewing this hot spot.
bestFOV: The best field of view for viewing this hot spot.
bestViewCenter: The best view center for viewing this hot spot.
hotSpotRect: The bounding box for this hot spot, specified as the number of pixels in full panoramic space. This field is valid only for panoramic nodes.
flags: A set of hot spot flags. Currently, this field is unused.
reserved1: Reserved. This field must be 0.
reserved2: Reserved. This field must be 0.